home *** CD-ROM | disk | FTP | other *** search
/ TPUG - Toronto PET Users Group / TPUG Users Group CD / TPUG Users Group CD.iso / MSDOS / (m)aaf / ARCE206.DOC < prev    next >
Text File  |  1986-09-17  |  7KB  |  200 lines
  1.  
  2. ARCE Command
  3. ------------
  4.  
  5. Purpose:  To extract files from an ARC archive file.
  6.  
  7. Format:   ARCE  [d:][path]filename.ext  [filespecs...] [d:outpath] [/R]
  8.  
  9. Remarks:  The drive and path names are optional. If omitted, the
  10.         current drive and path name is used.
  11.  
  12.         The filename must be supplied. The extension defaults
  13.         to ARC. All files matching the supplied filename are
  14.         processed. The ARC filename may contain the * and ?
  15.         wildcard characters.
  16.  
  17.         If no filespecs are supplied, all files are extracted.
  18.         Otherwise, only those ARC members which match one of the
  19.         up to 16 filespecs are extracted.
  20.  
  21.         The extracted files may be placed on another drive, and/or
  22.         in another subdirectory by following the optional filespecs
  23.         with a drive designator and/or path name.
  24.  
  25.         If the file being extracted already exists, you are asked
  26.         whether or not you want to over-write it. You may use the
  27.         /R option to bypass this prompt.
  28.  
  29.  
  30.  Examples:
  31.  --------
  32.  
  33.         o  Extract all file from TEST.ARC onto the current drive:
  34.  
  35.               ARCE TEST
  36.  
  37.         o  Extract only file with an extension of .ASM from the
  38.            archive SOURCE.ARC on drive B and in subdirectory SAVE:
  39.  
  40.               ARCE B:\SAVE\SOURCE *.ASM
  41.  
  42.         o  Extract all files from all ARC files in the subdirectory
  43.            called TEST on drive C:
  44.  
  45.               ARCE C:\TEST\*
  46.  
  47.         o  Extract all files from PROGA.ARC and place the files in
  48.            subdirectory OLD on drive B:
  49.  
  50.               ARCE PROGA.ARC B:\OLD
  51.  
  52.         o  Extract all files with an extension of .COM and .EXE from
  53.            the archive PROGS.ARC in directory NEW\WORK on drive B,
  54.            and place the them in subdirectory SAVE\TEST on drive A;
  55.            replace existing file:
  56.  
  57.               ARCE B:\NEW\WORK\PROGS *.COM *.EXE A:\SAVE\TEST /R
  58.  
  59.  
  60.  Error Messages:
  61.  --------------
  62.  
  63.         'filename - premature EOF reading '
  64.          Data is missing from the archive file.
  65.          The program is terminated.
  66.  
  67.  
  68.         'filename - unable to set file datestamp'
  69.          The file datestamp is set to the current date and time,
  70.          and the next archive member is processed.
  71.  
  72.  
  73.         'filename - WARNING: file CRC does not match!'
  74.          The extracted member is left on the output disk,
  75.          and the next archive member is processed. The file
  76.          is probably invalid but is left on the disk for
  77.          your examination.
  78.  
  79.  
  80.         'Invalid filespec(s)'
  81.          The filespec syntax is incorrect. The filename part
  82.          may be from 1 to eight characters, and may include the
  83.          ? or * wildcard characters. The extension may be none
  84.          to three  characters, and may include wildcards.
  85.          There is a maximum of 16 filespecs allowed.
  86.          The program terminates.
  87.  
  88.  
  89.         'filename - file already exists. Overwrite it? (y/N) '
  90.          The member being extracted already exists. If you are
  91.          using a data path utility, the file may not actually
  92.          be in the subdirectory be used for output. Respond
  93.          with the letter Y to over-write the existing file, or
  94.          respond with the letter N to skip this member and
  95.          continue to the next.
  96.  
  97.  
  98.         'Abort: Stack overflow'
  99.          The member being extracted has invalid data. The
  100.          program is terminated.
  101.  
  102.  
  103.         'filename - invalid decode tree count'
  104.          The member being extracted has invalid data. The
  105.          program is terminated.
  106.  
  107.  
  108.         'filename - new archive format 7 not yet supported'
  109.          Format 7 is a special file compression method used
  110.          internally by SEA, the authors of ARC. Processing
  111.          continues with the next archive member.
  112.  
  113.  
  114.         'Unable to open archive > arcname'
  115.          The specified ARC archive file was not found, or was
  116.          inaccessible. The program terminates.
  117.  
  118.  
  119.         'CREATE failed > filename'
  120.          There was insufficient directory space, or a failure
  121.          accessing the output disk. The program terminates.
  122.  
  123.  
  124.         'Invalid archive format!'
  125.          The archive file data is invalid. The program
  126.          terminates.
  127.  
  128.  
  129.         'Incorrect DOS version'
  130.          Version 2.0 or later of PC DOS must be used. The
  131.          program terminates
  132.  
  133.  
  134.         'Not enough memory.'
  135.          A minimum of 112k bytes of memory is required. The
  136.          program terminates.
  137.  
  138.  
  139.         'I/O error reading from arcname'
  140.          An incorrectable error occurred attempting to read
  141.          data  from the archive file. The program terminates.
  142.  
  143.  
  144.         'I/O error writing or disk full > filename'
  145.          There was not enough disk space to write the complete
  146.          archive member. The partially extracted file is
  147.          scratched and the program terminates.
  148.  
  149.  
  150.         'No matching file(s) found'
  151.          No archive files were found that matched the supplied
  152.          filename specifications. The program terminates.
  153.  
  154.  
  155.  Version history:
  156.  ---------------
  157.  
  158.         1.1 - 1/13/86, initial release
  159.         1.2 - 1/14/86, correct 'Not enough memory' checking
  160.         1.3 - 1/19/86, make displays MS-DOS compatible
  161.         1.4 - 1/24/86, add error messages for new ARC 5.0 formats
  162.         1.5 - 2/24/86, adds adaptive LZW decompression for code 8
  163.         1.6 - 3/02/86, adds file selection operands
  164.         1.7 - 3/04/86, optimizes performance
  165.                         adds stack checking for munged LZ files
  166.         1.8 - 3/15/86, modifies CRC computation for more speed
  167.         1.9 - 3/16/85, minor changes
  168.         1.10 - 3/24/86, adds wildcards for ARC file name
  169.         1.11 - 3/25/86, improves UnCrunch performance
  170.         1.12 - 3/28/86, corrects problem with 0-byte files
  171.                         adds outspec operand
  172.         1.13 - 4/01/86, increases stack size for 'crunched' files
  173.                         correct 'Not enough memory' checking
  174.         1.14 - make displays MS-DOS compatible
  175.         1.15 - add error messages for new ARC 5.0 formats
  176.         1.16 - add stack checking for munged LZ files
  177.                added adaptive LZW deompression for code 8
  178.         1.17 - added file selection
  179.         1.18 - cosmetic changes
  180.         1.19, 3/15/86 - improved CRC calculation speed
  181.         1.20, 3/16/85 - changed test for file already exists
  182.         1.21, 3/24/86 - added wildcard for ARC file name
  183.         1.22, 3/25/86 - cosmetic changes
  184.         1.23, 3/28/86 - correct short and empty file problems
  185.         2.00, 04/08/86 - fine tuning of I/O buffering
  186.         2.01-2.05, 4-20 thru 9/9/86 - improve unsq, correct disk full message
  187.         2.06, 9/17/86 - release from testing
  188.  
  189.  Notice:
  190.  ------
  191.         By Vernon D. Buerg, Wayne Chin, and A. Kumar; for the IBM PC
  192.         using DOS 2.0 or later. All rights reserved.
  193.  
  194.                 Vernon D. Buerg
  195.                 456 Lakeshire Drive
  196.                 Daly City, CA  94015
  197.                 CompuServe: 70007,1212
  198.                 Data/RBBS:  415-994-2944
  199.  
  200.